home *** CD-ROM | disk | FTP | other *** search
/ SGI Developer Toolbox 6.1 / SGI Developer Toolbox 6.1 - Disc 4.iso / documents / RFC / rfc1516.txt < prev    next >
Text File  |  1994-08-01  |  83KB  |  2,243 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7. Network Working Group                                        D. McMaster
  8. Request for Comments: 1516                SynOptics Communications, Inc.
  9. Obsoletes: 1368                                            K. McCloghrie
  10.                                                 Hughes LAN Systems, Inc.
  11.                                                           September 1993
  12.  
  13.  
  14.                      Definitions of Managed Objects
  15.                     for IEEE 802.3 Repeater Devices
  16.  
  17. Status of this Memo
  18.  
  19.    This RFC specifies an Internet standards track protocol for the
  20.    Internet community, and requests discussion and suggestions for
  21.    improvements.  Please refer to the current edition of the "Internet
  22.    Official Protocol Standards" for the standardization state and status
  23.    of this protocol.  Distribution of this memo is unlimited.
  24.  
  25. Abstract
  26.  
  27.    This memo defines a portion of the Management Information Base (MIB)
  28.    for use with network management protocols in the Internet community.
  29.    In particular, it defines objects for managing IEEE 802.3 10
  30.    Mb/second baseband repeaters, sometimes referred to as "hubs."
  31.  
  32. Table of Contents
  33.  
  34.    1. The Network Management Framework ......................    2
  35.    1.1 Object Definitions ...................................    2
  36.    2. Overview ..............................................    2
  37.    2.1 Terminology ..........................................    3
  38.    2.1.1 Repeaters, Hubs and Concentrators ..................    3
  39.    2.1.2 Repeaters, Ports, and MAUs .........................    3
  40.    2.1.3 Ports and Groups ...................................    5
  41.    2.1.4 Internal Ports and MAUs ............................    6
  42.    2.2 Supporting Functions .................................    7
  43.    2.3 Structure of MIB .....................................    9
  44.    2.3.1 The Basic Group Definitions ........................   10
  45.    2.3.2 The Monitor Group Definitions ......................   10
  46.     2.3.3 The Address Tracking Group Definitions ............   10
  47.    2.4 Relationship to Other MIBs ...........................   10
  48.    2.4.1 Relationship to the 'system' group .................   10
  49.    2.4.2 Relationship to the 'interfaces' group .............   10
  50.    2.5 Textual Conventions ..................................   11
  51.    3. Definitions ...........................................   11
  52.    3.1 MIB Groups in the Repeater MIB .......................   12
  53.    3.2 The Basic Group Definitions ..........................   13
  54.    3.3 The Monitor Group Definitions ........................   23
  55.  
  56.  
  57.  
  58. McMaster & McCloghrie                                           [Page 1]
  59.  
  60. RFC 1516                   802.3 Repeater MIB             September 1993
  61.  
  62.  
  63.    3.4 The Address Tracking Group Definitions ...............   34
  64.    3.5 Traps for use by Repeaters ...........................   36
  65.    4. Changes from RFC 1368 .................................   38
  66.    5. Acknowledgments .......................................   39
  67.    6. References ............................................   39
  68.    7. Security Considerations ...............................   40
  69.    8. Authors' Addresses ....................................   40
  70.  
  71. 1.  The Network Management Framework
  72.  
  73.    The Internet-standard Network Management Framework consists of
  74.     three components.  They are:
  75.  
  76.       o STD 16, RFC 1155 which defines the SMI, the mechanisms used for
  77.         describing and naming objects for the purpose of management.
  78.         STD 16, RFC 1212 defines a more concise description mechanism,
  79.         which is wholly consistent with the SMI.
  80.  
  81.       o STD 17, RFC 1213 defines MIB-II, the core set of managed objects
  82.         for the Internet suite of protocols.
  83.  
  84.       o STD 15, RFC 1157 which defines the SNMP, the protocol used for
  85.         network access to managed objects.
  86.  
  87.    The Framework permits new objects to be defined for the purpose of
  88.    experimentation and evaluation.
  89.  
  90. 1.1.  Object Definitions
  91.  
  92.    Managed objects are accessed via a virtual information store, termed
  93.    the Management Information Base or MIB.  Objects in the MIB are
  94.    defined using the subset of Abstract Syntax Notation One (ASN.1)
  95.    defined in the SMI.  In particular, each object object type is named
  96.    by an OBJECT IDENTIFIER, an administratively assigned name.  The
  97.    object type together with an object instance serves to uniquely
  98.    identify a specific instantiation of the object.  For human
  99.    convenience, we often use a textual string, termed the descriptor, to
  100.    refer to the object type.
  101.  
  102. 2.  Overview
  103.  
  104.    Instances of the object types defined in this memo represent
  105.    attributes of an IEEE 802.3 (Ethernet-like) repeater, as defined by
  106.    Section 9, "Repeater Unit for 10 Mb/s Baseband Networks" in the IEEE
  107.    802.3/ISO 8802-3 CSMA/CD standard [7].
  108.  
  109.    These Repeater MIB objects may be used to manage non-standard
  110.    repeater-like devices, but defining objects to describe
  111.  
  112.  
  113.  
  114. McMaster & McCloghrie                                           [Page 2]
  115.  
  116. RFC 1516                   802.3 Repeater MIB             September 1993
  117.  
  118.  
  119.    implementation-specific properties of non-standard repeater-like
  120.    devices is outside the scope of this memo.
  121.  
  122.    The definitions presented here are based on the IEEE draft standard
  123.    P802.3K, "Layer Management for 10 Mb/s Baseband Repeaters" [8].
  124.    Implementors of these MIB objects should note that [8] explicitly
  125.    describes when, where, and how various repeater attributes are
  126.    measured.  The IEEE document also describes the effects of repeater
  127.    actions that may be invoked by manipulating instances of the MIB
  128.    objects defined here.
  129.  
  130.    The counters in this document are defined to be the same as those
  131.    counters in the IEEE 802.3 Repeater Management draft, with the
  132.    intention that the same instrumentation can be used to implement both
  133.    the IEEE and IETF management standards.
  134.  
  135. 2.1.  Terminology
  136.  
  137. 2.1.1.  Repeaters, Hubs and Concentrators
  138.  
  139.    In late 1988, the IEEE 802.3 Hub Management task force was chartered
  140.    to define managed objects for both 802.3 repeaters and the proposed
  141.    10BASE-FA synchronous active stars.  The term "hub" was used to cover
  142.    both repeaters and active stars.
  143.  
  144.    In March, 1991, the active star proposal was dropped from the
  145.    10BASE-F draft.  Subsequently the 802.3 group changed the name of the
  146.    task force to be the IEEE 802.3 Repeater Management Task Force, and
  147.    likewise renamed their draft.
  148.  
  149.    The use of the term "hub" has led to some confusion, as the terms
  150.    "hub," "intelligent hub," and "concentrator" are often used to
  151.    indicate a modular chassis with plug-in modules that provide
  152.    generalized LAN/WAN connectivity, often with a mix of 802.3 repeater,
  153.    token ring, and FDDI connectivity, internetworked by bridges,
  154.    routers, and terminal servers.
  155.  
  156.    To be clear that this work covers the management of IEEE 802.3
  157.    repeaters only, the editors of this MIB definitions document chose to
  158.    call this a "Repeater MIB" instead of a "Hub MIB."
  159.  
  160. 2.1.2.  Repeaters, Ports, and MAUs
  161.  
  162.    The following text roughly defines the terms "repeater," "port," and
  163.    "MAU" as used in the context of this memo.  This text is imprecise
  164.    and omits many technical details.  For a more complete and precise
  165.    definition of these terms, refer to Section 9 of [7].
  166.  
  167.  
  168.  
  169.  
  170. McMaster & McCloghrie                                           [Page 3]
  171.  
  172. RFC 1516                   802.3 Repeater MIB             September 1993
  173.  
  174.  
  175.    An IEEE 802.3 repeater connects "Ethernet-like" media segments
  176.    together to extend the network length and topology beyond what can be
  177.    achieved with a single coax segment.  It can be pictured as a star
  178.    structure with two or more input/output ports.  The diagram below
  179.    illustrates a 6-port repeater:
  180.  
  181.                            ^      ^
  182.                            |      |
  183.                           \ \   / /
  184.                            \ \ / /
  185.                        _____\ v /_____
  186.                     -> ______   ______ ->
  187.                             / ^ \
  188.                            / / \ \
  189.                           / /   \ \
  190.                            |      |
  191.                            v      v
  192.  
  193.                     Figure 1.  Repeater Unit
  194.  
  195.    All the stations on the media segments connected to a given
  196.    repeater's ports participate in a single collision domain.  A packet
  197.    transmitted by any of these stations is seen by all of these
  198.    stations.
  199.  
  200.    Data coming in on any port in the repeater is transmitted out through
  201.    each of the remaining n-1 ports.  If data comes in to the repeater on
  202.    two or more ports simultaneously or the repeater detects a collision
  203.    on the incoming port, the repeater transmits a jamming signal out on
  204.    all ports for the duration of the collision.
  205.  
  206.    A repeater is a bit-wise store-and-forward device.  It is
  207.    differentiated from a bridge (a frame store-and-forward device) in
  208.    that it is primarily concerned with carrier sense and data bits, and
  209.    does not make data-handling decisions based on the legality or
  210.    contents of a packet.  A repeater retransmits data bits as they are
  211.    received.  Its data FIFO holds only enough bits to make sure that the
  212.    FIFO does not underflow when the data rate of incoming bits is
  213.    slightly slower than the repeater's transmission rate.
  214.  
  215.    A repeater is not an end-station on the network, and does not count
  216.    toward the overall limit of 1024 stations.  A repeater has no MAC
  217.    address associated with it, and therefore packets may not be
  218.    addressed to the repeater or to its ports.  (Packets may be addressed
  219.    to the MAC address of a management entity that is monitoring a
  220.    repeater.  This management entity may or may not be connected to the
  221.    network through one of the repeater's ports.  How the management
  222.    entity obtains information about the activity on the repeater is an
  223.  
  224.  
  225.  
  226. McMaster & McCloghrie                                           [Page 4]
  227.  
  228. RFC 1516                   802.3 Repeater MIB             September 1993
  229.  
  230.  
  231.    implementation issue, and is not discussed in this memo.)
  232.  
  233.    A repeater is connected to the network with Medium Attachment Units
  234.    (MAUs), and sometimes through Attachment Unit Interfaces (AUIs) as
  235.    well.  ("MAUs" are also known as transceivers, and an "AUI" is the
  236.    same as a 15-pin Ethernet or DIX connector.)
  237.  
  238.    The 802.3 standard defines a "repeater set" as the "repeater unit"
  239.    plus its associated MAUs (and AUIs if present).  The "repeater unit"
  240.    is defined as the portion of the repeater set that is inboard of the
  241.    physical media interfaces.  The MAUs may be physically separate from
  242.    the repeater unit, or they may be integrated into the same physical
  243.    package.
  244.  
  245.                         (MAU)   (MAU)
  246.                           \ \   / /
  247.                            \ \ / /
  248.                        _____\ v /_____
  249.                  (MAU) ______   ______ (MAU)
  250.                             / ^ \
  251.                            / / \ \
  252.                           / /   \ \
  253.                         (MAU)   (MAU)
  254.  
  255.                     Figure 2.  Repeater Set
  256.  
  257.    The most commonly-used MAUs are the 10BASE-5 (AUI to thick "yellow"
  258.    coax), 10BASE-2 (BNC to thin coax), 10BASE-T (unshielded twisted-
  259.    pair), and FOIRL (asynchronous fiber optic inter-repeater link, which
  260.    is being combined into the 10BASE-F standard as 10BASE-FL).  The
  261.    draft 10BASE-F standard also includes the definition for a new
  262.    synchronous fiber optic attachment, known as 10BASE-FB.
  263.  
  264.    It should be stressed that the repeater MIB being defined by the IEEE
  265.    covers only the repeater unit management - it does not include
  266.    management of the MAUs that form the repeater set.  The IEEE
  267.    recognizes that MAU management should be the same for MAUs connected
  268.    to end-stations (DTEs) as it is for MAUs connected to repeaters.
  269.    This memo follows the same strategy; the definition of management
  270.    information for MAUs is being addressed in a separate memo.
  271.  
  272. 2.1.3.  Ports and Groups
  273.  
  274.    Repeaters are often implemented in modular "concentrators," where a
  275.    card cage holds several field-replaceable cards.  Several cards may
  276.    form a single repeater unit, with each card containing one or more of
  277.    the repeater's ports.  Because of this modular architecture, users
  278.    typically identify these repeater ports with a card number plus the
  279.  
  280.  
  281.  
  282. McMaster & McCloghrie                                           [Page 5]
  283.  
  284. RFC 1516                   802.3 Repeater MIB             September 1993
  285.  
  286.  
  287.    port number relative to the card, e.g., Card 3, Port 11.
  288.  
  289.    To support this modular numbering scheme, this document follows the
  290.    example of the IEEE Repeater Management draft [8], allowing an
  291.    implementor to separate the ports in a repeater into "groups", if
  292.    desired.  For example, an implementor might choose to represent
  293.    field-replaceable units as groups of ports so that the port numbering
  294.    would match the modular hardware implementation.
  295.  
  296.    This group mapping is recommended but optional.  An implementor may
  297.    choose to put all of a modular repeater's ports into a single group,
  298.    or to divide the ports into groups that do not match physical
  299.    divisions.
  300.  
  301.    The object rptrGroupCapacity, which has a maximum value of 1024,
  302.    indicates the maximum number of groups that a given repeater may
  303.    contain.  The value of rptrGroupCapacity must remain constant from
  304.    one management restart to the next.
  305.  
  306.    Each group within the repeater is uniquely identified by a group
  307.    number in the range 1..rptrGroupCapacity.  Groups may come and go
  308.    without causing a management reset, and may be sparsely numbered
  309.    within the repeater.  For example, in a 12- card cage, cards 3, 5, 6,
  310.    and 7 may together form a single repeater, and the implementor may
  311.    choose to number them as groups 3, 5, 6, and 7, respectively.
  312.  
  313.    The object rptrGroupPortCapacity, which also has a maximum value of
  314.    1024, indicates the maximum number of ports that a given group may
  315.    contain.  The value of rptrGroupPortCapacity must not change for a
  316.    given group.  However, a group may be deleted from the repeater and
  317.    replaced with a group containing a different number of ports.  The
  318.    value of rptrGroupLastOperStatusChange will indicate that a change
  319.    took place.
  320.  
  321.    Each port within the repeater is uniquely identified by a combination
  322.    of group number and port number, where port number is an integer in
  323.    the range 1..rptrGroupPortCapacity.  As with groups within a
  324.    repeater, ports within a group may be sparsely numbered.  Likewise,
  325.    ports may come and go within a group without causing a management
  326.    reset.
  327.  
  328. 2.1.4.  Internal Ports and MAUs
  329.  
  330.    Repeater ports may be thought of as sources of traffic into the
  331.    repeater.  In addition to the externally visible ports mentioned
  332.    above, such as those with 10BASE-T MAUs, or AUI ports with external
  333.    transceivers, some implementations may have internal ports that are
  334.    not obvious to the end-user but are nevertheless sources of traffic
  335.  
  336.  
  337.  
  338. McMaster & McCloghrie                                           [Page 6]
  339.  
  340. RFC 1516                   802.3 Repeater MIB             September 1993
  341.  
  342.  
  343.    into the repeater.  Examples include internal management ports,
  344.    through which an agent communicates, and ports connecting to a
  345.    backplane internal to the implementation.
  346.  
  347.    Some implementations may not manage all of a repeater's ports.  For
  348.    managed ports, there must be entries in the port table; unmanaged
  349.    ports will not show up in the table.
  350.  
  351.    It is the decision of the implementor to select the appropriate
  352.    group(s) in which to place internal ports.  GroupCapacity for a given
  353.    group always reflects the number of MANAGED ports in that group.
  354.  
  355.    If some ports are unmanaged such that not all packet sources are
  356.    represented by managed ports, then the sum of the input counters for
  357.    the repeater will not equal the actual output of the repeater.
  358.  
  359. 2.2.  Supporting Functions
  360.  
  361.    The IEEE 802.3 Hub Management draft [8] defines the following seven
  362.    functions and seven signals used to describe precisely when port
  363.    counters are incremented.  The relationship between the functions and
  364.    signals is shown in Figure 3.
  365.  
  366.    The CollisionEvent, ActivityDuration, CarrierEvent, FramingError,
  367.    OctetCount, FCSError, and SourceAddress output signals defined here
  368.    are not retrievable MIB objects, but rather are concepts used in
  369.    defining the MIB objects.  The inputs are defined in Section 9 of the
  370.    IEEE 802.3 standard [7].
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394. McMaster & McCloghrie                                           [Page 7]
  395.  
  396. RFC 1516                   802.3 Repeater MIB             September 1993
  397.  
  398.  
  399.               +---------+
  400.               |Collision|--------------------->CollisionEvent
  401.    CollIn(X)+>|Event    |
  402.             | |Funct    |          +--------+
  403.             | +---------+          |Activity|
  404.             | +-------+            |Timing  |->ActivityDuration
  405.             +>|Carrier|      +---->|Funct   |
  406.               |Event  |      |     +--------+
  407.    DataIn(X)->|Funct  |+-----+---------------->CarrierEvent
  408.               +-------+|
  409.                        | +-------+
  410.                        +>|Framing|------------>FramingError
  411.                          |Funct  |  +-------+
  412.    decodedData---------->|       |+>|Octet  |
  413.                          +-------+| |Count  |->OctetCount
  414.                                   | |Funct  |
  415.                                   | +-------+
  416.                                   | +-------+
  417.                            Octet  | |Cyclic |
  418.                            Stream +>|Redund.|
  419.                                   | |Check  |->FCSError
  420.                                   | |Funct  |
  421.                                   | +-------+
  422.                                   | +-------+
  423.                                   | |Source |
  424.                                   +>|Address|->SourceAddress
  425.                                     |Funct  |
  426.                                     +-------+
  427.  
  428.              Figure 3.  Port Functions Relationship
  429.  
  430.    Collision Event Function:  The collision event function asserts the
  431.    CollisionEvent signal when the CollIn(X) variable has the value
  432.    SQE.  The CollisionEvent signal remains asserted until the assertion
  433.    of any CarrierEvent signal due to the reception of the following
  434.    event.
  435.  
  436.    Carrier Event Function:  The carrier event function asserts the
  437.    CarrierEvent signal when the repeater exits the IDLE state, Fig 9-2
  438.    [7], and the port has been determined to be port N.  It deasserts
  439.    the CarrierEvent signal when, for a duration of at least Carrier
  440.    Recovery Time (Ref: 9.5.6.5 [7]), both the DataIn(N) variable has
  441.    the value II and the CollIn(N) variable has the value -SQE.  The
  442.    value N is the port assigned at the time of transition from the IDLE
  443.    state.
  444.  
  445.    Framing Function:  The framing function recognizes the boundaries of
  446.    an incoming frame by monitoring the CarrierEvent signal and the
  447.  
  448.  
  449.  
  450. McMaster & McCloghrie                                           [Page 8]
  451.  
  452. RFC 1516                   802.3 Repeater MIB             September 1993
  453.  
  454.  
  455.    decoded data stream.  Data bits are accepted while the CarrierEvent
  456.    signal is asserted.  The framing function strips preamble and start
  457.    of frame delimiter from the received data stream.  The remaining
  458.    bits are aligned along octet boundaries.  If there is not an
  459.    integral number of octets, then FramingError shall be asserted.  The
  460.    FramingError signal is cleared upon the assertion of the
  461.    CarrierEvent signal due to the reception of the following event.
  462.  
  463.    Activity Timing Function:  The activity timing function measures the
  464.    duration of the assertion of the CarrierEvent signal.  This duration
  465.    value must be adjusted by removing the value of Carrier Recovery
  466.    Time (Ref: 9.5.6.5 [7]) to obtain the true duration of activity on
  467.    the network.  The output of the Activity Timing function is the
  468.    ActivityDuration value, which represents the duration of the
  469.    CarrierEvent signal as expressed in units of bit times.
  470.  
  471.    Octet Counting Function:  The octet counting function counts the
  472.    number of complete octets received from the output of the framing
  473.    function.  The output of the octet counting function is the
  474.    OctetCount value.  The OctetCount value is reset to zero upon the
  475.    assertion of the CarrierEvent signal due to the reception of the
  476.    following event.
  477.  
  478.    Cyclic Redundancy Check Function:  The cyclic redundancy check
  479.    function verifies that the sequence of octets output by the framing
  480.    function contains a valid frame check sequence field.  The frame
  481.    check sequence field is the last four octets received from the
  482.    output of the framing function.  The algorithm for generating an FCS
  483.    from the octet stream is specified in 3.2.8 [7].  If the FCS
  484.    generated according to this algorithm is not the same as the last
  485.    four octets received from the framing function then the FCSError
  486.    signal is asserted.  The FCSError signal is cleared upon the
  487.    assertion of the CarrierEvent signal due to the reception of the
  488.    following event.
  489.  
  490.    Source Address Function:  The source address function extracts
  491.    octets from the stream output by the framing function.  The seventh
  492.    through twelfth octets shall be extracted from the octet stream and
  493.    output as the SourceAddress variable.  The SourceAddress variable is
  494.    set to an invalid state upon the assertion of the CarrierEvent
  495.    signal due to the reception of the following event.
  496.  
  497. 2.3.  Structure of MIB
  498.  
  499.    Objects in this MIB are arranged into MIB groups.  Each MIB group is
  500.    organized as a set of related objects.
  501.  
  502.  
  503.  
  504.  
  505.  
  506. McMaster & McCloghrie                                           [Page 9]
  507.  
  508. RFC 1516                   802.3 Repeater MIB             September 1993
  509.  
  510.  
  511. 2.3.1.  The Basic Group Definitions
  512.  
  513.    This mandatory group contains the objects which are applicable to
  514.    all repeaters.  It contains status, parameter and control objects
  515.    for the repeater as a whole, the port groups within the repeater, as
  516.    well as for the individual ports themselves.
  517.  
  518. 2.3.2.  The Monitor Group Definitions
  519.  
  520.    This optional group contains monitoring statistics for the repeater
  521.    as a whole and for individual ports.
  522.  
  523. 2.3.3.  The Address Tracking Group Definitions
  524.  
  525.    This optional group contains objects for tracking the MAC addresses
  526.    of the DTEs attached to the ports of the repeater.
  527.  
  528. 2.4.  Relationship to Other MIBs
  529.  
  530.    It is assumed that a repeater implementing this MIB will also
  531.    implement (at least) the 'system' group defined in MIB-II [3].
  532.  
  533. 2.4.1.  Relationship to the 'system' group
  534.  
  535.    In MIB-II, the 'system' group is defined as being mandatory for all
  536.    systems such that each managed entity contains one instance of each
  537.    object in the 'system' group.  Thus, those objects apply to the
  538.    entity even if the entity's sole functionality is management of a
  539.    repeater.
  540.  
  541. 2.4.2.  Relationship to the 'interfaces' group
  542.  
  543.    In MIB-II, the 'interfaces' group is defined as being mandatory for
  544.    all systems and contains information on an entity's interfaces,
  545.    where each interface is thought of as being attached to a
  546.    the Internet suite of protocols.)
  547.  
  548.    This Repeater MIB uses the notion of ports on a repeater.  The
  549.    concept of a MIB-II interface has NO specific relationship to a
  550.    repeater's port.  Therefore, the 'interfaces' group applies only to
  551.    the one (or more) network interfaces on which the entity managing
  552.    the repeater sends and receives management protocol operations, and
  553.    does not apply to the repeater's ports.
  554.  
  555.    This is consistent with the physical-layer nature of a repeater.  A
  556.    repeater is a bitwise store-and-forward device.  It recognizes
  557.    activity and bits, but does not process incoming data based on any
  558.    packet-related information (such as checksum or addresses).  A
  559.  
  560.  
  561.  
  562. McMaster & McCloghrie                                          [Page 10]
  563.  
  564. RFC 1516                   802.3 Repeater MIB             September 1993
  565.  
  566.  
  567.    repeater has no MAC address, no MAC implementation, and does not
  568.    pass packets up to higher-level protocol entities for processing.
  569.  
  570.    (When a network management entity is observing the repeater, it may
  571.    appear as though the repeater is passing packets to a higher-level
  572.    protocol entity.  However, this is only a means of implementing
  573.    management, and this passing of management information is not part
  574.    of the repeater functionality.)
  575.  
  576. 2.5.  Textual Conventions
  577.  
  578.    The datatype MacAddress is used as a textual convention in this
  579.    document.  This textual convention has NO effect on either the
  580.    syntax nor the semantics of any managed object.  Objects defined
  581.    using this convention are always encoded by means of the rules that
  582.    define their primitive type.  Hence, no changes to the SMI or the
  583.    SNMP are necessary to accommodate this textual convention which is
  584.    adopted merely for the convenience of readers.
  585.  
  586. 3.  Definitions
  587.  
  588.    SNMP-REPEATER-MIB DEFINITIONS ::= BEGIN
  589.  
  590.    IMPORTS
  591.        Counter, TimeTicks, Gauge
  592.                                            FROM RFC1155-SMI
  593.        DisplayString                       FROM RFC1213-MIB
  594.        TRAP-TYPE                           FROM RFC-1215
  595.        OBJECT-TYPE                         FROM RFC-1212;
  596.  
  597.  
  598.    snmpDot3RptrMgt OBJECT IDENTIFIER ::= { mib-2 22 }
  599.  
  600.  
  601.    -- All representations of MAC addresses in this MIB Module use,
  602.    -- as a textual convention (i.e., this convention does not affect
  603.    -- their encoding), the data type:
  604.  
  605.    MacAddress ::= OCTET STRING (SIZE (6))    -- a 6 octet address in
  606.                                              -- the "canonical" order
  607.    -- defined by IEEE 802.1a, i.e., as if it were transmitted least
  608.    -- significant bit first.
  609.  
  610.  
  611.    --                      References
  612.    --
  613.    -- The following references are used throughout this MIB:
  614.    --
  615.  
  616.  
  617.  
  618. McMaster & McCloghrie                                          [Page 11]
  619.  
  620. RFC 1516                   802.3 Repeater MIB             September 1993
  621.  
  622.  
  623.    -- [IEEE 802.3 Std]
  624.    --    refers to IEEE 802.3/ISO 8802-3 Information processing
  625.    --    systems - Local area networks - Part 3: Carrier sense
  626.    --    multiple access with collision detection (CSMA/CD)
  627.    --    access method and physical layer specifications
  628.    --    (2nd edition, September 21, 1990).
  629.    --
  630.    -- [IEEE 802.3 Rptr Mgt]
  631.    --    refers to IEEE P802.3K, 'Layer Management for 10 Mb/s
  632.    --    Baseband Repeaters, Section 19,' Draft Supplement to
  633.    --    ANSI/IEEE 802.3, (Draft 8, April 9, 1992)
  634.  
  635.  
  636.    --                      MIB Groups
  637.    --
  638.    -- The rptrBasicPackage group is mandatory.
  639.    -- The rptrMonitorPackage and rptrAddrTrackPackage
  640.    -- groups are optional.
  641.  
  642.  
  643.    rptrBasicPackage
  644.        OBJECT IDENTIFIER ::= { snmpDot3RptrMgt 1 }
  645.  
  646.    rptrMonitorPackage
  647.        OBJECT IDENTIFIER ::= { snmpDot3RptrMgt 2 }
  648.  
  649.    rptrAddrTrackPackage
  650.        OBJECT IDENTIFIER ::= { snmpDot3RptrMgt 3 }
  651.  
  652.  
  653.    -- object identifiers for organizing the information
  654.    -- in the groups by repeater, port-group, and port
  655.  
  656.    rptrRptrInfo
  657.        OBJECT IDENTIFIER ::= { rptrBasicPackage 1 }
  658.    rptrGroupInfo
  659.        OBJECT IDENTIFIER ::= { rptrBasicPackage 2 }
  660.    rptrPortInfo
  661.        OBJECT IDENTIFIER ::= { rptrBasicPackage 3 }
  662.  
  663.    rptrMonitorRptrInfo
  664.        OBJECT IDENTIFIER ::= { rptrMonitorPackage 1 }
  665.    rptrMonitorGroupInfo
  666.        OBJECT IDENTIFIER ::= { rptrMonitorPackage 2 }
  667.    rptrMonitorPortInfo
  668.        OBJECT IDENTIFIER ::= { rptrMonitorPackage 3 }
  669.  
  670.    rptrAddrTrackRptrInfo     -- this subtree is currently unused
  671.  
  672.  
  673.  
  674. McMaster & McCloghrie                                          [Page 12]
  675.  
  676. RFC 1516                   802.3 Repeater MIB             September 1993
  677.  
  678.  
  679.        OBJECT IDENTIFIER ::= { rptrAddrTrackPackage 1 }
  680.    rptrAddrTrackGroupInfo    -- this subtree is currently unused
  681.        OBJECT IDENTIFIER ::= { rptrAddrTrackPackage 2 }
  682.    rptrAddrTrackPortInfo
  683.        OBJECT IDENTIFIER ::= { rptrAddrTrackPackage 3 }
  684.  
  685.  
  686.    --
  687.    --                    The BASIC GROUP
  688.    --
  689.    -- Implementation of the Basic Group is mandatory for all
  690.    -- managed repeaters.
  691.  
  692.    --
  693.    -- Basic Repeater Information
  694.    --
  695.    -- Configuration, status, and control objects for the overall
  696.    -- repeater
  697.    --
  698.  
  699.    rptrGroupCapacity OBJECT-TYPE
  700.        SYNTAX    INTEGER (1..1024)
  701.        ACCESS    read-only
  702.        STATUS    mandatory
  703.        DESCRIPTION
  704.                "The rptrGroupCapacity is the number of groups
  705.                that can be contained within the repeater.  Within
  706.                each managed repeater, the groups are uniquely
  707.                numbered in the range from 1 to rptrGroupCapacity.
  708.  
  709.                Some groups may not be present in the repeater, in
  710.                which case the actual number of groups present
  711.                will be less than rptrGroupCapacity.  The number
  712.                of groups present will never be greater than
  713.                rptrGroupCapacity.
  714.  
  715.                Note:  In practice, this will generally be the
  716.                number of field-replaceable units (i.e., modules,
  717.                cards, or boards) that can fit in the physical
  718.                repeater enclosure, and the group numbers will
  719.                correspond to numbers marked on the physical
  720.                enclosure."
  721.        REFERENCE
  722.                "Reference IEEE 802.3 Rptr Mgt, 19.2.3.2,
  723.                aRepeaterGroupCapacity."
  724.        ::= { rptrRptrInfo 1 }
  725.  
  726.    rptrOperStatus OBJECT-TYPE
  727.  
  728.  
  729.  
  730. McMaster & McCloghrie                                          [Page 13]
  731.  
  732. RFC 1516                   802.3 Repeater MIB             September 1993
  733.  
  734.  
  735.        SYNTAX  INTEGER {
  736.                    other(1),            -- undefined or unknown status
  737.                    ok(2),               -- no known failures
  738.                    rptrFailure(3),      -- repeater-related failure
  739.                    groupFailure(4),     -- group-related failure
  740.                    portFailure(5),      -- port-related failure
  741.                    generalFailure(6)    -- failure, unspecified type
  742.                }
  743.        ACCESS    read-only
  744.        STATUS    mandatory
  745.        DESCRIPTION
  746.                "The rptrOperStatus object indicates the
  747.                operational state of the repeater.  The
  748.                rptrHealthText object may be consulted for more
  749.                specific information about the state of the
  750.                repeater's health.
  751.  
  752.                In the case of multiple kinds of failures (e.g.,
  753.                repeater failure and port failure), the value of
  754.                this attribute shall reflect the highest priority
  755.                failure in the following order, listed highest
  756.                priority first:
  757.  
  758.                    rptrFailure(3)
  759.                    groupFailure(4)
  760.                    portFailure(5)
  761.                    generalFailure(6)."
  762.        REFERENCE
  763.                "Reference IEEE 802.3 Rptr Mgt, 19.2.3.2,
  764.                aRepeaterHealthState."
  765.        ::= { rptrRptrInfo 2 }
  766.  
  767.    rptrHealthText OBJECT-TYPE
  768.        SYNTAX    DisplayString (SIZE (0..255))
  769.        ACCESS    read-only
  770.        STATUS    mandatory
  771.        DESCRIPTION
  772.                "The health text object is a text string that
  773.                provides information relevant to the operational
  774.                state of the repeater.  Agents may use this string
  775.                to provide detailed information on current
  776.                failures, including how they were detected, and/or
  777.                instructions for problem resolution.  The contents
  778.                are agent-specific."
  779.        REFERENCE
  780.                "Reference IEEE 802.3 Rptr Mgt, 19.2.3.2,
  781.                aRepeaterHealthText."
  782.        ::= { rptrRptrInfo 3 }
  783.  
  784.  
  785.  
  786. McMaster & McCloghrie                                          [Page 14]
  787.  
  788. RFC 1516                   802.3 Repeater MIB             September 1993
  789.  
  790.  
  791.    rptrReset OBJECT-TYPE
  792.        SYNTAX    INTEGER {
  793.                      noReset(1),
  794.                      reset(2)
  795.                  }
  796.        ACCESS    read-write
  797.        STATUS    mandatory
  798.        DESCRIPTION
  799.                "Setting this object to reset(2) causes a
  800.                transition to the START state of Fig 9-2 in
  801.                section 9 [IEEE 802.3 Std].
  802.  
  803.                Setting this object to noReset(1) has no effect.
  804.                The agent will always return the value noReset(1)
  805.                when this object is read.
  806.  
  807.                After receiving a request to set this variable to
  808.                reset(2), the agent is allowed to delay the reset
  809.                for a short period.  For example, the implementor
  810.                may choose to delay the reset long enough to allow
  811.                the SNMP response to be transmitted.  In any
  812.                event, the SNMP response must be transmitted.
  813.  
  814.                This action does not reset the management counters
  815.                defined in this document nor does it affect the
  816.                portAdminStatus parameters.  Included in this
  817.                action is the execution of a disruptive Self-Test
  818.                with the following characteristics:  a) The nature
  819.                of the tests is not specified.  b) The test resets
  820.                the repeater but without affecting management
  821.                information about the repeater.  c) The test does
  822.                not inject packets onto any segment.  d) Packets
  823.                received during the test may or may not be
  824.                transferred.  e) The test does not interfere with
  825.                management functions.
  826.  
  827.                After performing this self-test, the agent will
  828.                update the repeater health information (including
  829.                rptrOperStatus and rptrHealthText), and send a
  830.                rptrHealth trap."
  831.        REFERENCE
  832.                "Reference IEEE 802.3 Rptr Mgt, 19.2.3.3,
  833.                acResetRepeater."
  834.        ::= { rptrRptrInfo 4 }
  835.  
  836.    rptrNonDisruptTest OBJECT-TYPE
  837.        SYNTAX    INTEGER {
  838.                      noSelfTest(1),
  839.  
  840.  
  841.  
  842. McMaster & McCloghrie                                          [Page 15]
  843.  
  844. RFC 1516                   802.3 Repeater MIB             September 1993
  845.  
  846.  
  847.                      selfTest(2)
  848.                  }
  849.        ACCESS    read-write
  850.        STATUS    mandatory
  851.        DESCRIPTION
  852.                "Setting this object to selfTest(2) causes the
  853.                repeater to perform a agent-specific, non-
  854.                disruptive self-test that has the following
  855.                characteristics:  a) The nature of the tests is
  856.                not specified.  b) The test does not change the
  857.                state of the repeater or management information
  858.                about the repeater.  c) The test does not inject
  859.                packets onto any segment.  d) The test does not
  860.                prevent the relay of any packets.  e) The test
  861.                does not interfere with management functions.
  862.  
  863.                After performing this test, the agent will update
  864.                the repeater health information (including
  865.                rptrOperStatus and rptrHealthText) and send a
  866.                rptrHealth trap.
  867.  
  868.                Note that this definition allows returning an
  869.                'okay' result after doing a trivial test.
  870.  
  871.                Setting this object to noSelfTest(1) has no
  872.                effect.  The agent will always return the value
  873.                noSelfTest(1) when this object is read."
  874.        REFERENCE
  875.                "Reference IEEE 802.3 Rptr Mgt, 19.2.3.3,
  876.                acExecuteNonDisruptiveSelfTest."
  877.        ::= { rptrRptrInfo 5 }
  878.  
  879.    rptrTotalPartitionedPorts OBJECT-TYPE
  880.        SYNTAX    Gauge
  881.        ACCESS    read-only
  882.        STATUS    mandatory
  883.        DESCRIPTION
  884.                "This object returns the total number of ports in
  885.                the repeater whose current state meets all three
  886.                of the following criteria:  rptrPortOperStatus
  887.                does not have the value notPresent(3),
  888.                rptrPortAdminStatus is enabled(1), and
  889.                rptrPortAutoPartitionState is autoPartitioned(2)."
  890.        ::= { rptrRptrInfo 6 }
  891.  
  892.  
  893.  
  894.  
  895.  
  896.  
  897.  
  898. McMaster & McCloghrie                                          [Page 16]
  899.  
  900. RFC 1516                   802.3 Repeater MIB             September 1993
  901.  
  902.  
  903.    --
  904.    -- The Basic Port Group Table
  905.    --
  906.  
  907.    rptrGroupTable OBJECT-TYPE
  908.        SYNTAX    SEQUENCE OF RptrGroupEntry
  909.        ACCESS    not-accessible
  910.        STATUS    mandatory
  911.        DESCRIPTION
  912.                "Table of descriptive and status information about
  913.                the groups of ports."
  914.        ::= { rptrGroupInfo 1 }
  915.  
  916.    rptrGroupEntry OBJECT-TYPE
  917.        SYNTAX    RptrGroupEntry
  918.        ACCESS    not-accessible
  919.        STATUS    mandatory
  920.        DESCRIPTION
  921.                "An entry in the table, containing information
  922.                about a single group of ports."
  923.        INDEX    { rptrGroupIndex }
  924.        ::= { rptrGroupTable 1 }
  925.  
  926.    RptrGroupEntry ::=
  927.        SEQUENCE {
  928.            rptrGroupIndex
  929.                INTEGER,
  930.            rptrGroupDescr
  931.                DisplayString,
  932.            rptrGroupObjectID
  933.                OBJECT IDENTIFIER,
  934.            rptrGroupOperStatus
  935.                INTEGER,
  936.            rptrGroupLastOperStatusChange
  937.                TimeTicks,
  938.            rptrGroupPortCapacity
  939.                INTEGER
  940.        }
  941.  
  942.    rptrGroupIndex OBJECT-TYPE
  943.        SYNTAX    INTEGER (1..1024)
  944.        ACCESS    read-only
  945.        STATUS    mandatory
  946.        DESCRIPTION
  947.                "This object identifies the group within the
  948.                repeater for which this entry contains
  949.                information.  This value is never greater than
  950.                rptrGroupCapacity."
  951.  
  952.  
  953.  
  954. McMaster & McCloghrie                                          [Page 17]
  955.  
  956. RFC 1516                   802.3 Repeater MIB             September 1993
  957.  
  958.  
  959.        REFERENCE
  960.                "Reference IEEE 802.3 Rptr Mgt, 19.2.5.2,
  961.                aGroupID."
  962.        ::= { rptrGroupEntry 1 }
  963.  
  964.    rptrGroupDescr OBJECT-TYPE
  965.        SYNTAX    DisplayString (SIZE (0..255))
  966.        ACCESS    read-only
  967.        STATUS    mandatory
  968.        DESCRIPTION
  969.                "A textual description of the group.  This value
  970.                should include the full name and version
  971.                identification of the group's hardware type and
  972.                indicate how the group is differentiated from
  973.                other types of groups in the repeater.  Plug-in
  974.                Module, Rev A' or 'Barney Rubble 10BASE-T 4-port
  975.                SIMM socket Version 2.1' are examples of valid
  976.                group descriptions.
  977.  
  978.                It is mandatory that this only contain printable
  979.                ASCII characters."
  980.        ::= { rptrGroupEntry 2 }
  981.  
  982.    rptrGroupObjectID OBJECT-TYPE
  983.        SYNTAX    OBJECT IDENTIFIER
  984.        ACCESS    read-only
  985.        STATUS    mandatory
  986.        DESCRIPTION
  987.                "The vendor's authoritative identification of the
  988.                group.  This value may be allocated within the SMI
  989.                enterprises subtree (1.3.6.1.4.1) and provides a
  990.                straight-forward and unambiguous means for
  991.                determining what kind of group is being managed.
  992.  
  993.                For example, this object could take the value
  994.                1.3.6.1.4.1.4242.1.2.14 if vendor 'Flintstones,
  995.                Inc.' was assigned the subtree 1.3.6.1.4.1.4242,
  996.                and had assigned the identifier
  997.                1.3.6.1.4.1.4242.1.2.14 to its 'Wilma Flintstone
  998.                6-Port FOIRL Plug-in Module.'"
  999.        ::= { rptrGroupEntry 3 }
  1000.  
  1001.    rptrGroupOperStatus OBJECT-TYPE
  1002.        SYNTAX    INTEGER {
  1003.                      other(1),
  1004.                      operational(2),
  1005.                      malfunctioning(3),
  1006.                      notPresent(4),
  1007.  
  1008.  
  1009.  
  1010. McMaster & McCloghrie                                          [Page 18]
  1011.  
  1012. RFC 1516                   802.3 Repeater MIB             September 1993
  1013.  
  1014.  
  1015.                      underTest(5),
  1016.                      resetInProgress(6)
  1017.                  }
  1018.        ACCESS    read-only
  1019.        STATUS    mandatory
  1020.        DESCRIPTION
  1021.                "An object that indicates the operational status
  1022.                of the group.
  1023.  
  1024.                A status of notPresent(4) indicates that the group
  1025.                is temporarily or permanently physically and/or
  1026.                logically not a part of the repeater.  It is an
  1027.                implementation-specific matter as to whether the
  1028.                agent effectively removes notPresent entries from
  1029.                the table.
  1030.  
  1031.                A status of operational(2) indicates that the
  1032.                group is functioning, and a status of
  1033.                malfunctioning(3) indicates that the group is
  1034.                malfunctioning in some way."
  1035.        ::= { rptrGroupEntry 4 }
  1036.  
  1037.    rptrGroupLastOperStatusChange OBJECT-TYPE
  1038.        SYNTAX    TimeTicks
  1039.        ACCESS    read-only
  1040.        STATUS    mandatory
  1041.        DESCRIPTION
  1042.                "An object that contains the value of sysUpTime at
  1043.                the time that the value of the rptrGroupOperStatus
  1044.                object for this group last changed.
  1045.  
  1046.                A value of zero indicates that the group's
  1047.                operational status has not changed since the agent
  1048.                last restarted."
  1049.        ::= { rptrGroupEntry 5 }
  1050.  
  1051.    rptrGroupPortCapacity OBJECT-TYPE
  1052.        SYNTAX    INTEGER (1..1024)
  1053.        ACCESS    read-only
  1054.        STATUS    mandatory
  1055.        DESCRIPTION
  1056.                "The rptrGroupPortCapacity is the number of ports
  1057.                that can be contained within the group.  Valid
  1058.                range is 1-1024.  Within each group, the ports are
  1059.                uniquely numbered in the range from 1 to
  1060.                rptrGroupPortCapacity.
  1061.  
  1062.                Note:  In practice, this will generally be the
  1063.  
  1064.  
  1065.  
  1066. McMaster & McCloghrie                                          [Page 19]
  1067.  
  1068. RFC 1516                   802.3 Repeater MIB             September 1993
  1069.  
  1070.  
  1071.                number of ports on a module, card, or board, and
  1072.                the port numbers will correspond to numbers marked
  1073.                on the physical embodiment."
  1074.        REFERENCE
  1075.                "Reference IEEE 802.3 Rptr Mgt, 19.2.5.2,
  1076.                aGroupPortCapacity."
  1077.        ::= { rptrGroupEntry 6 }
  1078.  
  1079.  
  1080.    --
  1081.    -- The Basic Port Table
  1082.    --
  1083.  
  1084.    rptrPortTable OBJECT-TYPE
  1085.        SYNTAX    SEQUENCE OF RptrPortEntry
  1086.        ACCESS    not-accessible
  1087.        STATUS    mandatory
  1088.        DESCRIPTION
  1089.                "Table of descriptive and status information about
  1090.                the ports."
  1091.        ::= { rptrPortInfo 1 }
  1092.  
  1093.    rptrPortEntry OBJECT-TYPE
  1094.        SYNTAX    RptrPortEntry
  1095.        ACCESS    not-accessible
  1096.        STATUS    mandatory
  1097.        DESCRIPTION
  1098.                "An entry in the table, containing information
  1099.                about a single port."
  1100.        INDEX    { rptrPortGroupIndex, rptrPortIndex }
  1101.        ::= { rptrPortTable 1 }
  1102.  
  1103.    RptrPortEntry ::=
  1104.        SEQUENCE {
  1105.            rptrPortGroupIndex
  1106.                INTEGER,
  1107.            rptrPortIndex
  1108.                INTEGER,
  1109.            rptrPortAdminStatus
  1110.                INTEGER,
  1111.            rptrPortAutoPartitionState
  1112.                INTEGER,
  1113.            rptrPortOperStatus
  1114.                INTEGER
  1115.        }
  1116.  
  1117.    rptrPortGroupIndex OBJECT-TYPE
  1118.        SYNTAX    INTEGER (1..1024)
  1119.  
  1120.  
  1121.  
  1122. McMaster & McCloghrie                                          [Page 20]
  1123.  
  1124. RFC 1516                   802.3 Repeater MIB             September 1993
  1125.  
  1126.  
  1127.        ACCESS    read-only
  1128.        STATUS    mandatory
  1129.        DESCRIPTION
  1130.                "This object identifies the group containing the
  1131.                port for which this entry contains information."
  1132.        ::= { rptrPortEntry 1 }
  1133.  
  1134.    rptrPortIndex OBJECT-TYPE
  1135.        SYNTAX    INTEGER (1..1024)
  1136.        ACCESS    read-only
  1137.        STATUS    mandatory
  1138.        DESCRIPTION
  1139.                "This object identifies the port within the group
  1140.                for which this entry contains information.  This
  1141.                value can never be greater than
  1142.                rptrGroupPortCapacity for the associated group."
  1143.        REFERENCE
  1144.                "Reference IEEE 802.3 Rptr Mgt, 19.2.6.2,
  1145.                aPortID."
  1146.        ::= { rptrPortEntry 2 }
  1147.  
  1148.    rptrPortAdminStatus OBJECT-TYPE
  1149.        SYNTAX    INTEGER {
  1150.                      enabled(1),
  1151.                      disabled(2)
  1152.                  }
  1153.        ACCESS    read-write
  1154.        STATUS    mandatory
  1155.        DESCRIPTION
  1156.                "Setting this object to disabled(2) disables the
  1157.                port.  A disabled port neither transmits nor
  1158.                receives.  Once disabled, a port must be
  1159.                explicitly enabled to restore operation.  A port
  1160.                which is disabled when power is lost or when a
  1161.                reset is exerted shall remain disabled when normal
  1162.                operation resumes.
  1163.  
  1164.                The admin status takes precedence over auto-
  1165.                partition and functionally operates between the
  1166.                auto-partition mechanism and the AUI/PMA.
  1167.  
  1168.                Setting this object to enabled(1) enables the port
  1169.                and exerts a BEGIN on the port's auto-partition
  1170.                state machine.
  1171.  
  1172.                (In effect, when a port is disabled, the value of
  1173.                rptrPortAutoPartitionState for that port is frozen
  1174.                until the port is next enabled.  When the port
  1175.  
  1176.  
  1177.  
  1178. McMaster & McCloghrie                                          [Page 21]
  1179.  
  1180. RFC 1516                   802.3 Repeater MIB             September 1993
  1181.  
  1182.  
  1183.                becomes enabled, the rptrPortAutoPartitionState
  1184.                becomes notAutoPartitioned(1), regardless of its
  1185.                pre-disabling state.)"
  1186.        REFERENCE
  1187.                "Reference IEEE 802.3 Rptr Mgt, 19.2.6.2,
  1188.                aPortAdminState and 19.2.6.3, acPortAdminControl."
  1189.        ::= { rptrPortEntry 3 }
  1190.  
  1191.    rptrPortAutoPartitionState OBJECT-TYPE
  1192.        SYNTAX    INTEGER {
  1193.                      notAutoPartitioned(1),
  1194.                      autoPartitioned(2)
  1195.                  }
  1196.        ACCESS    read-only
  1197.        STATUS    mandatory
  1198.        DESCRIPTION
  1199.                "The autoPartitionState flag indicates whether the
  1200.                port is currently partitioned by the repeater's
  1201.                auto-partition protection.
  1202.  
  1203.                The conditions that cause port partitioning are
  1204.                specified in partition state machine in Section 9
  1205.                [IEEE 802.3 Std].  They are not differentiated
  1206.                here."
  1207.        REFERENCE
  1208.                "Reference IEEE 802.3 Rptr Mgt, 19.2.6.2,
  1209.                aAutoPartitionState."
  1210.        ::= { rptrPortEntry 4 }
  1211.  
  1212.    rptrPortOperStatus  OBJECT-TYPE
  1213.        SYNTAX    INTEGER {
  1214.                      operational(1),
  1215.                      notOperational(2),
  1216.                      notPresent(3)
  1217.                  }
  1218.        ACCESS    read-only
  1219.        STATUS    mandatory
  1220.        DESCRIPTION
  1221.                "This object indicates the port's operational
  1222.                status.  The notPresent(3) status indicates the
  1223.                port is physically removed (note this may or may
  1224.                not be possible depending on the type of port.)
  1225.                The operational(1) status indicates that the port
  1226.                is enabled (see rptrPortAdminStatus) and working,
  1227.                even though it might be auto-partitioned (see
  1228.                rptrPortAutoPartitionState).
  1229.  
  1230.                If this object has the value operational(1) and
  1231.  
  1232.  
  1233.  
  1234. McMaster & McCloghrie                                          [Page 22]
  1235.  
  1236. RFC 1516                   802.3 Repeater MIB             September 1993
  1237.  
  1238.  
  1239.                rptrPortAdminStatus is set to disabled(2), it is
  1240.                expected that this object's value will soon change
  1241.                to notOperational(2)."
  1242.        ::= { rptrPortEntry 5 }
  1243.  
  1244.  
  1245.    --
  1246.    --                    The MONITOR GROUP
  1247.    --
  1248.    -- Implementation of this group is optional, but within the
  1249.    -- group all elements are mandatory.  If a managed repeater
  1250.    -- implements any part of this group, the entire group shall
  1251.    -- be implemented.
  1252.  
  1253.    --
  1254.    -- Repeater Monitor Information
  1255.    --
  1256.    -- Performance monitoring statistics for the repeater
  1257.    --
  1258.  
  1259.    rptrMonitorTransmitCollisions OBJECT-TYPE
  1260.        SYNTAX    Counter
  1261.        ACCESS    read-only
  1262.        STATUS    mandatory
  1263.        DESCRIPTION
  1264.                "This counter is incremented every time the
  1265.                repeater state machine enters the TRANSMIT
  1266.                COLLISION state from any state other than ONE PORT
  1267.                LEFT (Ref: Fig 9-2, IEEE 802.3 Std).
  1268.  
  1269.                The approximate minimum time for rollover of this
  1270.                counter is 16 hours."
  1271.        REFERENCE
  1272.                "Reference IEEE 802.3 Rptr Mgt, 19.2.3.2,
  1273.                aTransmitCollisions."
  1274.        ::= { rptrMonitorRptrInfo 1 }
  1275.  
  1276.  
  1277.    --
  1278.    -- The Group Monitor Table
  1279.    --
  1280.  
  1281.    rptrMonitorGroupTable OBJECT-TYPE
  1282.        SYNTAX    SEQUENCE OF RptrMonitorGroupEntry
  1283.        ACCESS    not-accessible
  1284.        STATUS    mandatory
  1285.        DESCRIPTION
  1286.                "Table of performance and error statistics for the
  1287.  
  1288.  
  1289.  
  1290. McMaster & McCloghrie                                          [Page 23]
  1291.  
  1292. RFC 1516                   802.3 Repeater MIB             September 1993
  1293.  
  1294.  
  1295.                groups."
  1296.        ::= { rptrMonitorGroupInfo 1 }
  1297.  
  1298.    rptrMonitorGroupEntry OBJECT-TYPE
  1299.        SYNTAX    RptrMonitorGroupEntry
  1300.        ACCESS    not-accessible
  1301.        STATUS    mandatory
  1302.        DESCRIPTION
  1303.                "An entry in the table, containing total
  1304.                performance and error statistics for a single
  1305.                group.  Regular retrieval of the information in
  1306.                this table provides a means of tracking the
  1307.                performance and health of the networked devices
  1308.                attached to this group's ports.
  1309.  
  1310.                The counters in this table are redundant in the
  1311.                sense that they are the summations of information
  1312.                already available through other objects.  However,
  1313.                these sums provide a considerable optimization of
  1314.                network management traffic over the otherwise
  1315.                necessary retrieval of the individual counters
  1316.                included in each sum."
  1317.        INDEX    { rptrMonitorGroupIndex }
  1318.        ::= { rptrMonitorGroupTable 1 }
  1319.  
  1320.    RptrMonitorGroupEntry ::=
  1321.        SEQUENCE {
  1322.            rptrMonitorGroupIndex
  1323.                INTEGER,
  1324.            rptrMonitorGroupTotalFrames
  1325.                Counter,
  1326.            rptrMonitorGroupTotalOctets
  1327.                Counter,
  1328.            rptrMonitorGroupTotalErrors
  1329.                Counter
  1330.        }
  1331.  
  1332.    rptrMonitorGroupIndex OBJECT-TYPE
  1333.        SYNTAX    INTEGER (1..1024)
  1334.        ACCESS    read-only
  1335.        STATUS    mandatory
  1336.        DESCRIPTION
  1337.                "This object identifies the group within the
  1338.                repeater for which this entry contains
  1339.                information."
  1340.        ::= { rptrMonitorGroupEntry 1 }
  1341.  
  1342.    rptrMonitorGroupTotalFrames OBJECT-TYPE
  1343.  
  1344.  
  1345.  
  1346. McMaster & McCloghrie                                          [Page 24]
  1347.  
  1348. RFC 1516                   802.3 Repeater MIB             September 1993
  1349.  
  1350.  
  1351.        SYNTAX    Counter
  1352.        ACCESS    read-only
  1353.        STATUS    mandatory
  1354.        DESCRIPTION
  1355.                "The total number of frames of valid frame length
  1356.                that have been received on the ports in this group
  1357.                and for which the FCSError and CollisionEvent
  1358.                signals were not asserted.  This counter is the
  1359.                summation of the values of the
  1360.                rptrMonitorPortReadableFrames counters for all of
  1361.                the ports in the group.
  1362.  
  1363.                This statistic provides one of the parameters
  1364.                necessary for obtaining the packet error rate.
  1365.                The approximate minimum time for rollover of this
  1366.                counter is 80 hours."
  1367.        ::= { rptrMonitorGroupEntry 2 }
  1368.  
  1369.    rptrMonitorGroupTotalOctets OBJECT-TYPE
  1370.        SYNTAX    Counter
  1371.        ACCESS    read-only
  1372.        STATUS    mandatory
  1373.        DESCRIPTION
  1374.                "The total number of octets contained in the valid
  1375.                frames that have been received on the ports in
  1376.                this group.  This counter is the summation of the
  1377.                values of the rptrMonitorPortReadableOctets
  1378.                counters for all of the ports in the group.
  1379.  
  1380.                This statistic provides an indicator of the total
  1381.                data transferred.  The approximate minimum time
  1382.                for rollover of this counter is 58 minutes."
  1383.        ::= { rptrMonitorGroupEntry 3 }
  1384.  
  1385.    rptrMonitorGroupTotalErrors OBJECT-TYPE
  1386.        SYNTAX    Counter
  1387.        ACCESS    read-only
  1388.        STATUS    mandatory
  1389.        DESCRIPTION
  1390.                "The total number of errors which have occurred on
  1391.                all of the ports in this group.  This counter is
  1392.                the summation of the values of the
  1393.                rptrMonitorPortTotalErrors counters for all of the
  1394.                ports in the group."
  1395.        ::= { rptrMonitorGroupEntry 4 }
  1396.  
  1397.    --
  1398.    -- The Port Monitor Table
  1399.  
  1400.  
  1401.  
  1402. McMaster & McCloghrie                                          [Page 25]
  1403.  
  1404. RFC 1516                   802.3 Repeater MIB             September 1993
  1405.  
  1406.  
  1407.    --
  1408.  
  1409.    rptrMonitorPortTable OBJECT-TYPE
  1410.        SYNTAX    SEQUENCE OF RptrMonitorPortEntry
  1411.        ACCESS    not-accessible
  1412.        STATUS    mandatory
  1413.        DESCRIPTION
  1414.                "Table of performance and error statistics for the
  1415.                ports."
  1416.        ::= { rptrMonitorPortInfo 1 }
  1417.  
  1418.    rptrMonitorPortEntry OBJECT-TYPE
  1419.        SYNTAX    RptrMonitorPortEntry
  1420.        ACCESS    not-accessible
  1421.        STATUS    mandatory
  1422.        DESCRIPTION
  1423.                "An entry in the table, containing performance and
  1424.                error statistics for a single port."
  1425.        INDEX    { rptrMonitorPortGroupIndex, rptrMonitorPortIndex }
  1426.        ::= { rptrMonitorPortTable 1 }
  1427.  
  1428.    RptrMonitorPortEntry ::=
  1429.        SEQUENCE {
  1430.            rptrMonitorPortGroupIndex
  1431.                INTEGER,
  1432.            rptrMonitorPortIndex
  1433.                INTEGER,
  1434.            rptrMonitorPortReadableFrames
  1435.                Counter,
  1436.            rptrMonitorPortReadableOctets
  1437.                Counter,
  1438.            rptrMonitorPortFCSErrors
  1439.                Counter,
  1440.            rptrMonitorPortAlignmentErrors
  1441.                Counter,
  1442.            rptrMonitorPortFrameTooLongs
  1443.                Counter,
  1444.            rptrMonitorPortShortEvents
  1445.                Counter,
  1446.            rptrMonitorPortRunts
  1447.                Counter,
  1448.            rptrMonitorPortCollisions
  1449.                Counter,
  1450.            rptrMonitorPortLateEvents
  1451.                Counter,
  1452.            rptrMonitorPortVeryLongEvents
  1453.                Counter,
  1454.            rptrMonitorPortDataRateMismatches
  1455.  
  1456.  
  1457.  
  1458. McMaster & McCloghrie                                          [Page 26]
  1459.  
  1460. RFC 1516                   802.3 Repeater MIB             September 1993
  1461.  
  1462.  
  1463.                Counter,
  1464.            rptrMonitorPortAutoPartitions
  1465.                Counter,
  1466.            rptrMonitorPortTotalErrors
  1467.                Counter
  1468.        }
  1469.  
  1470.    rptrMonitorPortGroupIndex OBJECT-TYPE
  1471.        SYNTAX    INTEGER (1..1024)
  1472.        ACCESS    read-only
  1473.        STATUS    mandatory
  1474.        DESCRIPTION
  1475.                "This object identifies the group containing the
  1476.                port for which this entry contains information."
  1477.        ::= { rptrMonitorPortEntry 1 }
  1478.  
  1479.    rptrMonitorPortIndex OBJECT-TYPE
  1480.        SYNTAX    INTEGER (1..1024)
  1481.        ACCESS    read-only
  1482.        STATUS    mandatory
  1483.        DESCRIPTION
  1484.                "This object identifies the port within the group
  1485.                for which this entry contains information."
  1486.        REFERENCE
  1487.                "Reference IEEE 802.3 Rptr Mgt, 19.2.6.2,
  1488.                aPortID."
  1489.        ::= { rptrMonitorPortEntry 2 }
  1490.  
  1491.    rptrMonitorPortReadableFrames OBJECT-TYPE
  1492.        SYNTAX    Counter
  1493.        ACCESS    read-only
  1494.        STATUS    mandatory
  1495.        DESCRIPTION
  1496.                "This object is the number of frames of valid
  1497.                frame length that have been received on this port.
  1498.                This counter is incremented by one for each frame
  1499.                received on this port whose OctetCount is greater
  1500.                than or equal to minFrameSize and less than or
  1501.                equal to maxFrameSize (Ref: IEEE 802.3 Std,
  1502.                4.4.2.1) and for which the FCSError and
  1503.                CollisionEvent signals are not asserted.
  1504.  
  1505.                This statistic provides one of the parameters
  1506.                necessary for obtaining the packet error rate.
  1507.                The approximate minimum time for rollover of this
  1508.                counter is 80 hours."
  1509.        REFERENCE
  1510.                "Reference IEEE 802.3 Rptr Mgt, 19.2.6.2,
  1511.  
  1512.  
  1513.  
  1514. McMaster & McCloghrie                                          [Page 27]
  1515.  
  1516. RFC 1516                   802.3 Repeater MIB             September 1993
  1517.  
  1518.  
  1519.                aReadableFrames."
  1520.        ::= { rptrMonitorPortEntry 3 }
  1521.  
  1522.    rptrMonitorPortReadableOctets OBJECT-TYPE
  1523.        SYNTAX    Counter
  1524.        ACCESS    read-only
  1525.        STATUS    mandatory
  1526.        DESCRIPTION
  1527.                "This object is the number of octets contained in
  1528.                valid frames that have been received on this port.
  1529.                This counter is incremented by OctetCount for each
  1530.                frame received on this port which has been
  1531.                determined to be a readable frame (i.e., including
  1532.                FCS octets but excluding framing bits and dribble
  1533.                bits).
  1534.  
  1535.                This statistic provides an indicator of the total
  1536.                data transferred.  The approximate minimum time
  1537.                for rollover of this counter is 58 minutes."
  1538.        REFERENCE
  1539.                "Reference IEEE 802.3 Rptr Mgt, 19.2.6.2,
  1540.                aReadableOctets."
  1541.        ::= { rptrMonitorPortEntry 4 }
  1542.  
  1543.    rptrMonitorPortFCSErrors OBJECT-TYPE
  1544.        SYNTAX    Counter
  1545.        ACCESS    read-only
  1546.        STATUS    mandatory
  1547.        DESCRIPTION
  1548.                "This counter is incremented by one for each frame
  1549.                received on this port with the FCSError signal
  1550.                asserted and the FramingError and CollisionEvent
  1551.                signals deasserted and whose OctetCount is greater
  1552.                than or equal to minFrameSize and less than or
  1553.                equal to maxFrameSize (Ref: 4.4.2.1, IEEE 802.3
  1554.                Std).
  1555.  
  1556.                The approximate minimum time for rollover of this
  1557.                counter is 80 hours."
  1558.        REFERENCE
  1559.                "Reference IEEE 802.3 Rptr Mgt, 19.2.6.2,
  1560.                aFrameCheckSequenceErrors."
  1561.        ::= { rptrMonitorPortEntry 5 }
  1562.  
  1563.    rptrMonitorPortAlignmentErrors OBJECT-TYPE
  1564.        SYNTAX    Counter
  1565.        ACCESS    read-only
  1566.        STATUS    mandatory
  1567.  
  1568.  
  1569.  
  1570. McMaster & McCloghrie                                          [Page 28]
  1571.  
  1572. RFC 1516                   802.3 Repeater MIB             September 1993
  1573.  
  1574.  
  1575.        DESCRIPTION
  1576.                "This counter is incremented by one for each frame
  1577.                received on this port with the FCSError and
  1578.                FramingError signals asserted and CollisionEvent
  1579.                signal deasserted and whose OctetCount is greater
  1580.                than or equal to minFrameSize and less than or
  1581.                equal to maxFrameSize (Ref: IEEE 802.3 Std,
  1582.                4.4.2.1).  If rptrMonitorPortAlignmentErrors is
  1583.                incremented then the rptrMonitorPortFCSErrors
  1584.                Counter shall not be incremented for the same
  1585.                frame.
  1586.  
  1587.                The approximate minimum time for rollover of this
  1588.                counter is 80 hours."
  1589.        REFERENCE
  1590.                "Reference IEEE 802.3 Rptr Mgt, 19.2.6.2,
  1591.                aAlignmentErrors."
  1592.        ::= { rptrMonitorPortEntry 6 }
  1593.  
  1594.    rptrMonitorPortFrameTooLongs OBJECT-TYPE
  1595.        SYNTAX    Counter
  1596.        ACCESS    read-only
  1597.        STATUS    mandatory
  1598.        DESCRIPTION
  1599.                "This counter is incremented by one for each frame
  1600.                received on this port whose OctetCount is greater
  1601.                than maxFrameSize (Ref: 4.4.2.1, IEEE 802.3 Std).
  1602.                If rptrMonitorPortFrameTooLongs is incremented
  1603.                then neither the rptrMonitorPortAlignmentErrors
  1604.                nor the rptrMonitorPortFCSErrors counter shall be
  1605.                incremented for the frame.
  1606.  
  1607.                The approximate minimum time for rollover of this
  1608.                counter is 61 days."
  1609.        REFERENCE
  1610.                "Reference IEEE 802.3 Rptr Mgt, 19.2.6.2,
  1611.                aFramesTooLong."
  1612.        ::= { rptrMonitorPortEntry 7 }
  1613.  
  1614.    rptrMonitorPortShortEvents OBJECT-TYPE
  1615.        SYNTAX    Counter
  1616.        ACCESS    read-only
  1617.        STATUS    mandatory
  1618.        DESCRIPTION
  1619.                "This counter is incremented by one for each
  1620.                CarrierEvent on this port with ActivityDuration
  1621.                less than ShortEventMaxTime.  ShortEventMaxTime is
  1622.                greater than 74 bit times and less than 82 bit
  1623.  
  1624.  
  1625.  
  1626. McMaster & McCloghrie                                          [Page 29]
  1627.  
  1628. RFC 1516                   802.3 Repeater MIB             September 1993
  1629.  
  1630.  
  1631.                times.  ShortEventMaxTime has tolerances included
  1632.                to provide for circuit losses between a
  1633.                conformance test point at the AUI and the
  1634.                measurement point within the state machine.
  1635.  
  1636.                Note:  shortEvents may indicate externally
  1637.                generated noise hits which will cause the repeater
  1638.                to transmit Runts to its other ports, or propagate
  1639.                a collision (which may be late) back to the
  1640.                transmitting DTE and damaged frames to the rest of
  1641.                the network.
  1642.  
  1643.                Implementors may wish to consider selecting the
  1644.                ShortEventMaxTime towards the lower end of the
  1645.                allowed tolerance range to accommodate bit losses
  1646.                suffered through physical channel devices not
  1647.                budgeted for within this standard.
  1648.  
  1649.                The approximate minimum time for rollover of this
  1650.                counter is 16 hours."
  1651.        REFERENCE
  1652.                "Reference IEEE 802.3 Rptr Mgt, 19.2.6.2,
  1653.                aShortEvents."
  1654.        ::= { rptrMonitorPortEntry 8 }
  1655.  
  1656.    rptrMonitorPortRunts OBJECT-TYPE
  1657.        SYNTAX    Counter
  1658.        ACCESS    read-only
  1659.        STATUS    mandatory
  1660.        DESCRIPTION
  1661.                "This counter is incremented by one for each
  1662.                CarrierEvent on this port that meets one of the
  1663.                following two conditions.  Only one test need be
  1664.                made.  a) The ActivityDuration is greater than
  1665.                ShortEventMaxTime and less than ValidPacketMinTime
  1666.                and the CollisionEvent signal is deasserted.  b)
  1667.                The OctetCount is less than 64, the
  1668.                ActivityDuration is greater than ShortEventMaxTime
  1669.                and the CollisionEvent signal is deasserted.
  1670.                ValidPacketMinTime is greater than or equal to 552
  1671.                bit times and less than 565 bit times.
  1672.  
  1673.                An event whose length is greater than 74 bit times
  1674.                but less than 82 bit times shall increment either
  1675.                the shortEvents counter or the runts counter but
  1676.                not both.  A CarrierEvent greater than or equal to
  1677.                552 bit times but less than 565 bit times may or
  1678.                may not be counted as a runt.
  1679.  
  1680.  
  1681.  
  1682. McMaster & McCloghrie                                          [Page 30]
  1683.  
  1684. RFC 1516                   802.3 Repeater MIB             September 1993
  1685.  
  1686.  
  1687.                ValidPacketMinTime has tolerances included to
  1688.                provide for circuit losses between a conformance
  1689.                test point at the AUI and the measurement point
  1690.                within the state machine.
  1691.  
  1692.                Runts usually indicate collision fragments, a
  1693.                normal network event.  In certain situations
  1694.                associated with large diameter networks a
  1695.                percentage of collision fragments may exceed
  1696.                ValidPacketMinTime.
  1697.  
  1698.                The approximate minimum time for rollover of this
  1699.                counter is 16 hours."
  1700.        REFERENCE
  1701.                "Reference IEEE 802.3 Rptr Mgt, 19.2.6.2, aRunts."
  1702.        ::= { rptrMonitorPortEntry 9 }
  1703.  
  1704.    rptrMonitorPortCollisions OBJECT-TYPE
  1705.        SYNTAX    Counter
  1706.        ACCESS    read-only
  1707.        STATUS    mandatory
  1708.        DESCRIPTION
  1709.                "This counter is incremented by one for any
  1710.                CarrierEvent signal on any port for which the
  1711.                CollisionEvent signal on this port is also
  1712.                asserted.
  1713.  
  1714.                The approximate minimum time for rollover of this
  1715.                counter is 16 hours."
  1716.        REFERENCE
  1717.                "Reference IEEE 802.3 Rptr Mgt, 19.2.6.2,
  1718.                aCollisions."
  1719.        ::= { rptrMonitorPortEntry 10 }
  1720.  
  1721.    rptrMonitorPortLateEvents OBJECT-TYPE
  1722.        SYNTAX    Counter
  1723.        ACCESS    read-only
  1724.        STATUS    mandatory
  1725.        DESCRIPTION
  1726.                "This counter is incremented by one for each
  1727.                CarrierEvent on this port in which the CollIn(X)
  1728.                variable transitions to the value SQE (Ref:
  1729.                9.6.6.2, IEEE 802.3 Std) while the
  1730.                ActivityDuration is greater than the
  1731.                LateEventThreshold.  Such a CarrierEvent is
  1732.                counted twice, as both a collision and as a
  1733.                lateEvent.
  1734.  
  1735.  
  1736.  
  1737.  
  1738. McMaster & McCloghrie                                          [Page 31]
  1739.  
  1740. RFC 1516                   802.3 Repeater MIB             September 1993
  1741.  
  1742.  
  1743.                The LateEventThreshold is greater than 480 bit
  1744.                times and less than 565 bit times.
  1745.                LateEventThreshold has tolerances included to
  1746.                permit an implementation to build a single
  1747.                threshold to serve as both the LateEventThreshold
  1748.                and ValidPacketMinTime threshold.
  1749.  
  1750.                The approximate minimum time for rollover of this
  1751.                counter is 81 hours."
  1752.        REFERENCE
  1753.                "Reference IEEE 802.3 Rptr Mgt, 19.2.6.2,
  1754.                aLateEvents."
  1755.        ::= { rptrMonitorPortEntry 11 }
  1756.  
  1757.    rptrMonitorPortVeryLongEvents OBJECT-TYPE
  1758.        SYNTAX    Counter
  1759.        ACCESS    read-only
  1760.        STATUS    mandatory
  1761.        DESCRIPTION
  1762.                "This counter is incremented by one for each
  1763.                CarrierEvent on this port whose ActivityDuration
  1764.                is greater than the MAU Jabber Lockup Protection
  1765.                timer TW3 (Ref: 9.6.1 & 9.6.5, IEEE 802.3 Std).
  1766.                Other counters may be incremented as appropriate."
  1767.        REFERENCE
  1768.                "Reference IEEE 802.3 Rptr Mgt, 19.2.6.2,
  1769.                aVeryLongEvents."
  1770.        ::= { rptrMonitorPortEntry 12 }
  1771.  
  1772.    rptrMonitorPortDataRateMismatches OBJECT-TYPE
  1773.        SYNTAX    Counter
  1774.        ACCESS    read-only
  1775.        STATUS    mandatory
  1776.        DESCRIPTION
  1777.                "This counter is incremented by one for each frame
  1778.                received on this port that meets all of the
  1779.                following conditions:  a) The CollisionEvent
  1780.                signal is not asserted.  b) The ActivityDuration
  1781.                is greater than ValidPacketMinTime.  c) The
  1782.                frequency (data rate) is detectably mismatched
  1783.                from the local transmit frequency.  The exact
  1784.                degree of mismatch is vendor specific and is to be
  1785.                defined by the vendor for conformance testing.
  1786.  
  1787.                When this event occurs, other counters whose
  1788.                increment conditions were satisfied may or may not
  1789.                also be incremented, at the implementor's
  1790.                discretion.  Whether or not the repeater was able
  1791.  
  1792.  
  1793.  
  1794. McMaster & McCloghrie                                          [Page 32]
  1795.  
  1796. RFC 1516                   802.3 Repeater MIB             September 1993
  1797.  
  1798.  
  1799.                to maintain data integrity is beyond the scope of
  1800.                this standard."
  1801.        REFERENCE
  1802.                "Reference IEEE 802.3 Rptr Mgt, 19.2.6.2,
  1803.                aDataRateMismatches."
  1804.        ::= { rptrMonitorPortEntry 13 }
  1805.  
  1806.    rptrMonitorPortAutoPartitions OBJECT-TYPE
  1807.        SYNTAX    Counter
  1808.        ACCESS    read-only
  1809.        STATUS    mandatory
  1810.        DESCRIPTION
  1811.                "This counter is incremented by one for each time
  1812.                the repeater has automatically partitioned this
  1813.                port.  The conditions that cause port partitioning
  1814.                are specified in the partition state machine in
  1815.                Section 9 [IEEE 802.3 Std].  They are not
  1816.                differentiated here."
  1817.        REFERENCE
  1818.                "Reference IEEE 802.3 Rptr Mgt, 19.2.6.2,
  1819.                aAutoPartitions."
  1820.        ::= { rptrMonitorPortEntry 14 }
  1821.  
  1822.    rptrMonitorPortTotalErrors OBJECT-TYPE
  1823.        SYNTAX    Counter
  1824.        ACCESS    read-only
  1825.        STATUS    mandatory
  1826.        DESCRIPTION
  1827.                "The total number of errors which have occurred on
  1828.                this port.  This counter is the summation of the
  1829.                values of other error counters (for the same
  1830.                port), namely:
  1831.  
  1832.                    rptrMonitorPortFCSErrors,
  1833.                    rptrMonitorPortAlignmentErrors,
  1834.                    rptrMonitorPortFrameTooLongs,
  1835.                    rptrMonitorPortShortEvents,
  1836.                    rptrMonitorPortLateEvents,
  1837.                    rptrMonitorPortVeryLongEvents, and
  1838.                    rptrMonitorPortDataRateMismatches.
  1839.  
  1840.                This counter is redundant in the sense that it is
  1841.                the summation of information already available
  1842.                through other objects.  However, it is included
  1843.                specifically because the regular retrieval of this
  1844.                object as a means of tracking the health of a port
  1845.                provides a considerable optimization of network
  1846.                management traffic over the otherwise necessary
  1847.  
  1848.  
  1849.  
  1850. McMaster & McCloghrie                                          [Page 33]
  1851.  
  1852. RFC 1516                   802.3 Repeater MIB             September 1993
  1853.  
  1854.  
  1855.                retrieval of the summed counters."
  1856.        ::= { rptrMonitorPortEntry 15 }
  1857.  
  1858.  
  1859.    --
  1860.    --                    The ADDRESS TRACKING GROUP
  1861.    --
  1862.    -- Implementation of this group is optional; it is appropriate
  1863.    -- for all systems which have the necessary instrumentation.  If a
  1864.    -- managed repeater implements any part of this group, the entire
  1865.    -- group shall be implemented.
  1866.  
  1867.    --
  1868.    -- The Port Address Tracking Table
  1869.    --
  1870.  
  1871.    rptrAddrTrackTable OBJECT-TYPE
  1872.        SYNTAX    SEQUENCE OF RptrAddrTrackEntry
  1873.        ACCESS    not-accessible
  1874.        STATUS    mandatory
  1875.        DESCRIPTION
  1876.                "Table of address mapping information about the
  1877.                ports."
  1878.        ::= { rptrAddrTrackPortInfo 1 }
  1879.  
  1880.    rptrAddrTrackEntry OBJECT-TYPE
  1881.        SYNTAX    RptrAddrTrackEntry
  1882.        ACCESS    not-accessible
  1883.        STATUS    mandatory
  1884.        DESCRIPTION
  1885.                "An entry in the table, containing address mapping
  1886.                information about a single port."
  1887.        INDEX    { rptrAddrTrackGroupIndex, rptrAddrTrackPortIndex }
  1888.        ::= { rptrAddrTrackTable 1 }
  1889.  
  1890.    RptrAddrTrackEntry ::=
  1891.        SEQUENCE {
  1892.            rptrAddrTrackGroupIndex
  1893.                INTEGER,
  1894.            rptrAddrTrackPortIndex
  1895.                INTEGER,
  1896.            rptrAddrTrackLastSourceAddress     -- DEPRECATED OBJECT
  1897.                MacAddress,
  1898.            rptrAddrTrackSourceAddrChanges
  1899.                Counter,
  1900.            rptrAddrTrackNewLastSrcAddress
  1901.                OCTET STRING
  1902.        }
  1903.  
  1904.  
  1905.  
  1906. McMaster & McCloghrie                                          [Page 34]
  1907.  
  1908. RFC 1516                   802.3 Repeater MIB             September 1993
  1909.  
  1910.  
  1911.    rptrAddrTrackGroupIndex OBJECT-TYPE
  1912.        SYNTAX    INTEGER (1..1024)
  1913.        ACCESS    read-only
  1914.        STATUS    mandatory
  1915.        DESCRIPTION
  1916.                "This object identifies the group containing the
  1917.                port for which this entry contains information."
  1918.        ::= { rptrAddrTrackEntry 1 }
  1919.  
  1920.    rptrAddrTrackPortIndex OBJECT-TYPE
  1921.        SYNTAX    INTEGER (1..1024)
  1922.        ACCESS    read-only
  1923.        STATUS    mandatory
  1924.        DESCRIPTION
  1925.                "This object identifies the port within the group
  1926.                for which this entry contains information."
  1927.        REFERENCE
  1928.                "Reference IEEE 802.3 Rptr Mgt, 19.2.6.2,
  1929.                aPortID."
  1930.        ::= { rptrAddrTrackEntry 2 }
  1931.  
  1932.    rptrAddrTrackLastSourceAddress OBJECT-TYPE
  1933.        SYNTAX    MacAddress
  1934.        ACCESS    read-only
  1935.        STATUS    deprecated
  1936.        DESCRIPTION
  1937.                "This object is the SourceAddress of the last
  1938.                readable frame (i.e., counted by
  1939.                rptrMonitorPortReadableFrames) received by this
  1940.                port.
  1941.  
  1942.                This object has been deprecated because its value
  1943.                is undefined when no frames have been observed on
  1944.                this port.  The replacement object is
  1945.                rptrAddrTrackNewLastSrcAddress."
  1946.        REFERENCE
  1947.                "Reference IEEE 802.3 Rptr Mgt, 19.2.6.2,
  1948.                aLastSourceAddress."
  1949.        ::= { rptrAddrTrackEntry 3 }
  1950.  
  1951.    rptrAddrTrackSourceAddrChanges OBJECT-TYPE
  1952.        SYNTAX    Counter
  1953.        ACCESS    read-only
  1954.        STATUS    mandatory
  1955.        DESCRIPTION
  1956.                "This counter is incremented by one for each time
  1957.                that the rptrAddrTrackLastSourceAddress attribute
  1958.                for this port has changed.
  1959.  
  1960.  
  1961.  
  1962. McMaster & McCloghrie                                          [Page 35]
  1963.  
  1964. RFC 1516                   802.3 Repeater MIB             September 1993
  1965.  
  1966.  
  1967.                This may indicate whether a link is connected to a
  1968.                single DTE or another multi-user segment.
  1969.  
  1970.                The approximate minimum time for rollover of this
  1971.                counter is 81 hours."
  1972.        REFERENCE
  1973.                "Reference IEEE 802.3 Rptr Mgt, 19.2.6.2,
  1974.                aSourceAddressChanges."
  1975.        ::= { rptrAddrTrackEntry 4 }
  1976.  
  1977.    rptrAddrTrackNewLastSrcAddress OBJECT-TYPE
  1978.        SYNTAX    OCTET STRING (SIZE(0 | 6))
  1979.        ACCESS    read-only
  1980.        STATUS    mandatory
  1981.        DESCRIPTION
  1982.                "This object is the SourceAddress of the last
  1983.                readable frame (i.e., counted by
  1984.                rptrMonitorPortReadableFrames) received by this
  1985.                port.  If no frames have been received by this
  1986.                port since the agent began monitoring the port
  1987.                activity, the agent shall return a string of
  1988.                length zero."
  1989.        REFERENCE
  1990.                "Reference IEEE 802.3 Rptr Mgt, 19.2.6.2,
  1991.                aLastSourceAddress."
  1992.        ::= { rptrAddrTrackEntry 5 }
  1993.  
  1994.  
  1995.    -- Traps for use by Repeaters
  1996.  
  1997.    -- Traps are defined using the conventions in RFC 1215 [6].
  1998.  
  1999.    rptrHealth TRAP-TYPE
  2000.        ENTERPRISE  snmpDot3RptrMgt
  2001.        VARIABLES   { rptrOperStatus }
  2002.        DESCRIPTION
  2003.                "The rptrHealth trap conveys information related
  2004.                to the operational status of the repeater.  This
  2005.                trap is sent either when the value of
  2006.                rptrOperStatus changes, or upon completion of a
  2007.                non-disruptive test.
  2008.  
  2009.                The rptrHealth trap must contain the
  2010.                rptrOperStatus object.  The agent may optionally
  2011.                include the rptrHealthText object in the varBind
  2012.                list.  See the rptrOperStatus and rptrHealthText
  2013.                objects for descriptions of the information that
  2014.                is sent.
  2015.  
  2016.  
  2017.  
  2018. McMaster & McCloghrie                                          [Page 36]
  2019.  
  2020. RFC 1516                   802.3 Repeater MIB             September 1993
  2021.  
  2022.  
  2023.                The agent must throttle the generation of
  2024.                consecutive rptrHealth traps so that there is at
  2025.                least a five-second gap between traps of this
  2026.                type.  When traps are throttled, they are dropped,
  2027.                not queued for sending at a future time.  (Note
  2028.                that 'generating' a trap means sending to all
  2029.                configured recipients.)"
  2030.        REFERENCE
  2031.                "Reference IEEE 802.3 Rptr Mgt, 19.2.3.4,
  2032.                hubHealth notification."
  2033.        ::= 1
  2034.  
  2035.    rptrGroupChange TRAP-TYPE
  2036.        ENTERPRISE  snmpDot3RptrMgt
  2037.        VARIABLES   { rptrGroupIndex }
  2038.        DESCRIPTION
  2039.                "This trap is sent when a change occurs in the
  2040.                group structure of a repeater.  This occurs only
  2041.                when a group is logically or physically removed
  2042.                from or added to a repeater.  The varBind list
  2043.                contains the identifier of the group that was
  2044.                removed or added.
  2045.  
  2046.                The agent must throttle the generation of
  2047.                consecutive rptrGroupChange traps for the same
  2048.                group so that there is at least a five-second gap
  2049.                between traps of this type.  When traps are
  2050.                throttled, they are dropped, not queued for
  2051.                sending at a future time.  (Note that 'generating'
  2052.                a trap means sending to all configured
  2053.                recipients.)"
  2054.        REFERENCE
  2055.                "Reference IEEE 802.3 Rptr Mgt, 19.2.3.4,
  2056.                groupMapChange notification."
  2057.        ::= 2
  2058.  
  2059.    rptrResetEvent TRAP-TYPE
  2060.        ENTERPRISE  snmpDot3RptrMgt
  2061.        VARIABLES   { rptrOperStatus }
  2062.        DESCRIPTION
  2063.                "The rptrResetEvent trap conveys information
  2064.                related to the operational status of the repeater.
  2065.                This trap is sent on completion of a repeater
  2066.                reset action.  A repeater reset action is defined
  2067.                as an a transition to the START state of Fig 9-2
  2068.                in section 9 [IEEE 802.3 Std], when triggered by a
  2069.                management command (e.g., an SNMP Set on the
  2070.                rptrReset object).
  2071.  
  2072.  
  2073.  
  2074. McMaster & McCloghrie                                          [Page 37]
  2075.  
  2076. RFC 1516                   802.3 Repeater MIB             September 1993
  2077.  
  2078.  
  2079.                The agent must throttle the generation of
  2080.                consecutive rptrResetEvent traps so that there is
  2081.                at least a five-second gap between traps of this
  2082.                type.  When traps are throttled, they are dropped,
  2083.                not queued for sending at a future time.  (Note
  2084.                that 'generating' a trap means sending to all
  2085.                configured recipients.)
  2086.  
  2087.                The rptrResetEvent trap is not sent when the agent
  2088.                restarts and sends an SNMP coldStart or warmStart
  2089.                trap.  However, it is recommended that a repeater
  2090.                agent send the rptrOperStatus object as an
  2091.                optional object with its coldStart and warmStart
  2092.                trap PDUs.
  2093.  
  2094.                The rptrOperStatus object must be included in the
  2095.                varbind list sent with this trap.  The agent may
  2096.                optionally include the rptrHealthText object as
  2097.                well."
  2098.        REFERENCE
  2099.                "Reference IEEE 802.3 Rptr Mgt, 19.2.3.4, hubReset
  2100.                notification."
  2101.        ::= 3
  2102.  
  2103.    END
  2104.  
  2105.  
  2106. 4.  Changes from RFC 1368
  2107.  
  2108.    (1)  Added section 2.1.4, "Internal Ports and MAUs," that defines
  2109.         internal ports and clarifies how they may or may not be
  2110.         managed.
  2111.  
  2112.    (2)  Noted that the failure list for rptrOperStatus is ordered
  2113.         highest priority first.
  2114.  
  2115.    (3)  Clarified rptrReset description to indicate that the agent
  2116.         may briefly delay the reset action.
  2117.  
  2118.    (4)  For rptrReset, clarified the actions that the agent should
  2119.         take after performing the reset and self-test.
  2120.  
  2121.    (5)  For rptrNonDisruptTest, similar change to (3).
  2122.  
  2123.    (6)  Clarified that the rptrNonDisruptTest description allows
  2124.         returning "ok" after doing only a trivial test.
  2125.  
  2126.    (7)  Deprecated rptrAddrTrackLastSourceAddress and defined a
  2127.  
  2128.  
  2129.  
  2130. McMaster & McCloghrie                                          [Page 38]
  2131.  
  2132. RFC 1516                   802.3 Repeater MIB             September 1993
  2133.  
  2134.  
  2135.         replacement object that has a zero-length value until the
  2136.         first frame is seen on the port.
  2137.  
  2138.    (8)  Clarified that rptrHealth trap is sent after
  2139.         rptrNonDisruptTest even if repeater health information
  2140.         doesn't change as a result of the test.
  2141.  
  2142.    (9)  Clarified text on throttling traps.
  2143.  
  2144. 5.  Acknowledgments
  2145.  
  2146.    This document is the work of the IETF Hub MIB Working Group.  It is
  2147.    based on drafts of the IEEE 802.3 Repeater Management Task Force.
  2148.  
  2149. 6.  References
  2150.  
  2151.    [1]  Rose M., and K. McCloghrie, "Structure and Identification of
  2152.         Management Information for TCP/IP-based internets", STD 16, RFC
  2153.         1155, Performance Systems International, Hughes LAN Systems, May
  2154.         1990.
  2155.  
  2156.    [2]  Case, J., Fedor, M., Schoffstall, M., and J. Davin, "Simple
  2157.         Network Management Protocol", STD 15, RFC 1157, SNMP Research,
  2158.         Performance Systems International, Performance Systems
  2159.         International, MIT Laboratory for Computer Science, May 1990.
  2160.  
  2161.    [3]  McCloghrie K., and M. Rose, Editors, "Management Information
  2162.         Base for Network Management of TCP/IP-based internets", STD 17,
  2163.         RFC 1213, Performance Systems International, March 1991.
  2164.  
  2165.    [4]  Information processing systems - Open Systems Interconnection -
  2166.         Specification of Abstract Syntax Notation One (ASN.1),
  2167.         International Organization for Standardization, International
  2168.         Standard 8824, December 1987.
  2169.  
  2170.    [5]  Rose, M., and K. McCloghrie, Editors, "Concise MIB Definitions",
  2171.         STD 16, RFC 1212, Performance Systems International, Hughes LAN
  2172.         Systems, March 1991.
  2173.  
  2174.    [6]  Rose, M., Editor, "A Convention for Defining Traps for use with
  2175.         the SNMP", RFC 1215, Performance Systems International, March
  2176.         1991.
  2177.  
  2178.    [7]  IEEE 802.3/ISO 8802-3 - Information processing systems - Local
  2179.         area networks - Part 3: Carrier sense multiple access with
  2180.         collision detection (CSMA/CD) access method and physical layer
  2181.         specifications, 2nd edition, 21 September 1990.
  2182.  
  2183.  
  2184.  
  2185.  
  2186. McMaster & McCloghrie                                          [Page 39]
  2187.  
  2188. RFC 1516                   802.3 Repeater MIB             September 1993
  2189.  
  2190.  
  2191.    [8]  IEEE P802.3K - Layer Management for 10 Mb/s Baseband Repeaters,
  2192.         Section 19, Draft Supplement to ANSI/IEEE 802.3, Draft 8, 9
  2193.         April 1992.
  2194.  
  2195. 7.  Security Considerations
  2196.  
  2197.    Security issues are not discussed in this memo.
  2198.  
  2199. 8.  Authors' Addresses
  2200.  
  2201.    Donna McMaster
  2202.    SynOptics Communications, Inc.
  2203.    4401 Great America Parkway
  2204.    P.O. Box 58185
  2205.    Santa Clara, CA 95052-8185
  2206.  
  2207.    Phone: (408) 764-1206
  2208.    EMail: mcmaster@synoptics.com
  2209.  
  2210.  
  2211.    Keith McCloghrie
  2212.    Hughes LAN Systems, Inc.
  2213.    1225 Charleston Road
  2214.    Mountain View, CA 94043
  2215.  
  2216.    Phone: (415) 966-7934
  2217.    EMail: kzm@hls.com
  2218.  
  2219.  
  2220.  
  2221.  
  2222.  
  2223.  
  2224.  
  2225.  
  2226.  
  2227.  
  2228.  
  2229.  
  2230.  
  2231.  
  2232.  
  2233.  
  2234.  
  2235.  
  2236.  
  2237.  
  2238.  
  2239.  
  2240.  
  2241.  
  2242. McMaster & McCloghrie                                          [Page 40]
  2243.